三维场景展示

最后更新时间：2019年6月17日

三维数据加载方法

功能描述

MapGIS Mobile for Android支持多种三维数据的展示，包括离线的三维矢量、地形、引用二维地图，以及在线的IGServer二维地图服务、三维服务、OGC服务、第三方通用地图服务等。接下来讲解各种数据的具体加载方法。

实现方法

（1）实例化三维图层对象，即各类数据图层：三维矢量图层（VectorLayer3D）、地形图层（TerrainLayer3D）、模型图层（ModelLayer3D）、服务图层（ServerLayer3D）、二维引用地图（MapRefLayer）等，然后设置必要的信息：数据驱动类型、URL、图层参考系；

（2）通过场景Scene对象的addLayer()、insertLayer()接口加载各类图层对象；

（3）通过场景视图SceneView对象调用setSceneAsync()接口设置加载场景数据。

离线矢量数据 Sample详情

支持移动端加载shp格式的离线矢量数据，在准备好数据之后，需拷贝到移动设备的存储目录中。接下来重点讲解离线矢量数据的加载方法，其他数据加载方法类似。

1

实例化场景视图

在xml布局文件中添加SceneView视图控件之后，在java程序代码中实例化其对象。

SceneView sceneView = findViewById(R.id.sceneView);

2

创建矢量图层对象

加载离线矢量数据，构造VectorLayer3D图层对象，根据数据具体情况设置驱动类型、URL、图层参考系信息。

//创建矢量图层对象
VectorLayer3D mVectorLayer3D=new VectorLayer3D();
//1-设置数据驱动类型
mVectorLayer3D.setDriverType(DriverType.Driver_Type_OGR);         //用于离线矢量数据的读取
//2-设置图层URL
String dataPath= android.os.Environment.getExternalStorageDirectory().getPath()+"/MapGIS Mobile 3D Sample/Scene/haiyang/haiyang.shp";                                //获取数据路径
mVectorLayer3D.setURL(dataPath);                                  //设置URL
//3-设置图层参考系
mVectorLayer3D.setSRSByString(SRSType.SRS_Type_Global_MERCATOR);  //WGS84,WEB墨卡托

重要说明：不同的三维数据需创建不同的图层对象，但都需要设置以下三部分信息。

（1）设置数据驱动类型-setDriverType()：根据数据类型设置不同的驱动类型，作用是便于数据的读取、处理。各种驱动类型的字段由DriverType类提供。

（2）设置图层URL-setURL()：设置数据URL，在线数据的URL、离线数据的本地文件路径。

（3）设置图层参考系-setSRSByString()：根据数据的真实空间参考系设置对应的参数。

下方表格展示了MapGIS Mobile支持的各种三维场景数据类型，以及采用的图层对象、对应的数据驱动类型。

空间参考系由SRSType类提供，目前只支持以下两种。

3

构造三维场景对象

三维场景图层构造完成后，即可构造三维场景对象，然后为其添加图层。

//创建三维场景Scene（全局变量）
Scene mScene = new Scene();	
//为Scene添加图层
mScene.addLayer(mVectorLayer3D);

4

场景加载

调用SceneView的setSceneAsync接口异步加载场景，并且提供回调函数，可以监听判断场景是否加载成功。

//为场景视图设置场景
sceneView.setSceneAsync(mScene, new SceneView.SceneFinishCallback() {
    @Override
    public void onDidFinish(boolean b) {
        if (b) {
            Toast.makeText(ShowVectorScene_Activity.this, "场景加载成功", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(ShowVectorScene_Activity.this, "场景加载失败", Toast.LENGTH_SHORT).show();
        }
    }
});

重要说明：场景加载整个流程中使用到的多个方法，都需要在MapGIS授权成功之后调用，否则不会起到任何作用。

离线三维地形 Sample详情

离线三维地形数据的加载方法和离线矢量数据类似，区别只在于三维图层的构建不一样。

//构建三维地形图层对象
TerrainLayer3D terrainLayer3D = new TerrainLayer3D();
//设置名称
terrainLayer3D.setName("三维地形");
//为图层设置驱动类型（GDAL数据驱动.用于离线栅格数据的读取）
terrainLayer3D.setDriverType(DriverType.Driver_Type_GDAL);
//设置URL：加载tif格式的地形数据
terrainLayer3D.setURL(android.os.Environment.getExternalStorageDirectory().getPath() + "/MapGIS Mobile 3D Sample/Scene/Tif/mt_everest_90m.tif");
//tif格式的地形数据无需设置空间参考系

离线三维影像 Sample详情

准备好tif格式影像数据后使用如下方法加载。

//实例化三维服务图层对象
ServerLayer3D mTifLayer = new ServerLayer3D();
mTifLayer.setName("影像数据");
//为图层设置驱动类型（GDAL数据驱动.用于离线栅格数据的读取）
mTifLayer.setDriverType(DriverType.Driver_Type_GDAL);
//设置URL
mTifLayer.setURL(android.os.Environment.getExternalStorageDirectory().getPath() + "/MapGIS Mobile 3D Sample/Scene/Tif/world.tif");
//设置图层数据的空间参考系（全球,WGS84,经纬度）
mTifLayer.setSRSByString(SRSType.SRS_Type_Global);

离线三维模型 Sample详情

以倾斜摄影模型数据加载为例，首先准备.osgb倾斜摄影原始数据，然后需要使用MapGIS桌面平台软件对原始模型处理生成.mcx模型缓存文件，完成后将原始数据和.mcx文件都拷贝至移动设备存储中，然后调用以下方法加载。

//实例化模型图层对象
ModelLayer3D modelLayer = new ModelLayer3D();
modelLayer.setName("离线三维模型");
//为图层设置驱动类型（MapGIS倾斜摄影数据驱动）
modelLayer.setDriverType(DriverType.Driver_Type_Model_MapGIS_OP);
//设置URL
modelLayer.setURL(android.os.Environment.getExternalStorageDirectory().getPath() + "/MapGIS Mobile 3D Sample/Scene/DaYanTa/dayanta.mcx");
//设置空间参考系（全球,WGS84,经纬度）
modelLayer.setSRSByString(SRSType.SRS_Type_Global);

IGServer二维矢量地图服务 Sample详情

三维场景中可以添加在IGServer服务器中发布的二维矢量地图服务。

//实例化地图服务（IGServer矢量数据服务）
MapServer mServer = ServerLayer3D.createMapServer(MapServer.MAPSERVER_TYPE_IGSERVER_VECTOR);
//设置URL，添加二维数据
mServer.setURL("http://develop.smaryun.com:6163/igs/rest/mrms/docs/WorldJWVector");

//实例化三维服务图层对象
ServerLayer3D mServerLayer3D = new ServerLayer3D();
mServerLayer3D.setMapServer(mServer);  //设置地图服务
mServerLayer3D.setName("IGServer服务");
//设置驱动类型（MapGIS三维服务驱动）
mServerLayer3D.setDriverType(DriverType.Driver_Type_MapGIS_Map);
//设置空间参考系
mServerLayer3D.setSRSByString(SRSType.SRS_Type_Global);  //经纬度

IGServer二维瓦片地图服务 Sample详情

三维场景中可以添加在IGServer服务器中发布的二维瓦片地图服务。

//实例化地图服务（IGServer瓦片服务）
MapServer mServer = ServerLayer3D.createMapServer(MapServer.MAPSERVER_TYPE_IGSERVER_TILE);
//设置URL
mServer.setURL("http://develop.smaryun.com:6163/igs/rest/mrms/tile/JWWORLDTILE");

//实例化三维服务图层对象
ServerLayer3D mServerLayer3D = new ServerLayer3D();
//为服务图层设置地图服务
mServerLayer3D.setMapServer(mServer);
mServerLayer3D.setName("IGServer瓦片数据");
//设置驱动类型（MapGIS地图服务驱动）
mServerLayer3D.setDriverType(DriverType.Driver_Type_MapGIS_Map);
//根据数据类型设置空间参考系类型
mServerLayer3D.setSRSByString(SRSType.SRS_Type_Global);  //经纬度

IGServer三维场景服务 Sample详情

首先需在IGServer服务器中发布三维场景服务，然后获取其URL，再调用以下方法加载展示。

//实例化地图服务（IGServer三维服务）
MapServer mServer = ServerLayer3D.createMapServer(MapServer.MAPSERVER_TYPE_IGSERVER_SCENE);
//设置URL
mServer.setURL("http://develop.smaryun.com:6163/igs/rest/g3d/WuHanJWScene");

//实例化三维服务图层对象
ServerLayer3D mServerLayer3D = new ServerLayer3D();
//为服务图层设置地图服务
mServerLayer3D.setMapServer(mServer);
mServerLayer3D.setName("IGServer服务");
//设置驱动类型（MapGIS三维服务驱动）
mServerLayer3D.setDriverType(DriverType.Driver_Type_MapGIS_3D);
//根据数据类型设置空间参考系类型，必须要加
mServerLayer3D.setSRSByString(SRSType.SRS_Type_Global);//经纬度

在线WMS服务 Sample详情

支持OGC标准中的WMS服务，可以加载发布在IGServer服务器中的WMS地图服务。

//创建地图服务
MapServer mServer = ServerLayer3D.createMapServer(MapServer.MAPSERVER_TYPE_OGC_WMS);
//设置URL
mServer.setURL("http://develop.smaryun.com:6163/igs/rest/ogc/doc/WorldJWVector/WMSServer");//地图文档服务

//实例化三维服务图层对象
ServerLayer3D mWMSLayer3D = new ServerLayer3D();
mWMSLayer3D.setMapServer(mServer);
mWMSLayer3D.setName("WMS三维数据");
//设置驱动类型（OGC WMS服务驱动）
mWMSLayer3D.setDriverType(DriverType.Driver_Type_WMS);
//根据数据类型设置空间参考系类型
mWMSLayer3D.setSRSByString(SRSType.SRS_Type_Global);//经纬度

在线TMS服务 Sample详情

获取TMS服务地址之后采用如下方法加载。

//实例化三维服务图层对象
ServerLayer3D mTMSLayer3D = new ServerLayer3D();
mTMSLayer3D.setName("TMS三维数据");
//设置驱动类型（TMS服务驱动）
mTMSLayer3D.setDriverType(DriverType.Driver_Type_TMS);
//空间参考系类型
mTMSLayer3D.setSRSByString(SRSType.SRS_Type_Global);
//设置URL
mTMSLayer3D.setURL("http://readymap.org/readymap/tiles/1.0.0/7/");

在线Google地图服务 Sample详情

获取Google地图服务地址后使用以下方法加载。

//实例化三维服务图层对象
ServerLayer3D mGoogleLayer3D = new ServerLayer3D();
mGoogleLayer3D.setName("Google三维数据");
//设置驱动类型（标准Web墨卡托地图服务驱动.如Google、百度等）
mGoogleLayer3D.setDriverType(DriverType.Driver_Type_XYZ);
//设置空间参考系类型（全球,WGS84,WEB墨卡托）
mGoogleLayer3D.setSRSByString(SRSType.SRS_Type_Global_MERCATOR);
//设置URL
mGoogleLayer3D.setURL("http://mt[0123].google.cn/vt/lyrs=s@106&gl=cn&x={x}&y={y}&z={z}&s=Gali");